Skip to content

SEO & metadata audit: MCP setup guide descriptions - #304

Merged
mintlify[bot] merged 1 commit into
mainfrom
mintlify/a60c6791
Jul 27, 2026
Merged

SEO & metadata audit: MCP setup guide descriptions#304
mintlify[bot] merged 1 commit into
mainfrom
mintlify/a60c6791

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Rewrite frontmatter descriptions on the newly added MCP setup pages (and the two related MCP overview pages) so each falls in the 130–160 character SEO window and is unique.

Changes

  • Lengthened short descriptions (85–122 chars) on mcp/setup/{chatgpt,claude,claude-code,cursor,other-clients,vs-code}.mdx to 147–160 chars with page-specific detail (connector, claude mcp add, deep link/mcp.json, OAuth 2.1 + API-key fallback, Copilot agent mode).
  • Shortened over-long descriptions on mcp/home.mdx (184 → 159) and api-docs/in-depth-guides/mcp.mdx (164 → 157).
  • Titles were already ≤ 60 characters, descriptive, and unique — left unchanged. Page bodies not touched.

Context

All eight MCP setup pages plus the MCP overview and quickstart were added in #302; the audit was scoped to that commit.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Greptile Summary

Updates SEO metadata descriptions across eight MCP overview and setup pages.

  • Rewrites each description to be unique and between 130 and 160 characters.
  • Adds page-specific setup details while leaving titles and page bodies unchanged.

Confidence Score: 5/5

The PR appears safe to merge with no actionable issues identified in the metadata-only changes.

All eight descriptions are unique, remain within the stated 130–160 character range, use valid YAML frontmatter syntax, and accurately reflect their corresponding setup guides.

Important Files Changed

Filename Overview
docs/api-docs/in-depth-guides/mcp.mdx Shortens the MCP quickstart description while accurately retaining its supported-client and tracking-data scope.
docs/mcp/home.mdx Rewrites the MCP overview description to emphasize OAuth-based access without changing page behavior.
docs/mcp/setup/chatgpt.mdx Expands the description with ChatGPT Developer mode, custom connector, and OAuth details consistent with the guide.
docs/mcp/setup/claude-code.mdx Adds the documented Claude Code command and browser sign-in flow to the description.
docs/mcp/setup/claude.mdx Clarifies the Claude custom connector and OAuth flow in metadata.
docs/mcp/setup/cursor.mdx Adds the documented Cursor deep-link and mcp.json setup options to the description.
docs/mcp/setup/other-clients.mdx Describes the documented OAuth registration and API-key fallback options for generic MCP clients.
docs/mcp/setup/vs-code.mdx Adds the documented VS Code Copilot agent mode, mcp.json, and OAuth details to the description.

Reviews (1): Last reviewed commit: "docs: tighten MCP setup guide descriptio..." | Re-trigger Greptile

Context used:

@vercel

vercel Bot commented Jul 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
api Building Building Preview, Comment Jul 27, 2026 12:10am

Request Review

@mintlify
mintlify Bot merged commit c3e94d8 into main Jul 27, 2026
9 of 10 checks passed
@mintlify

mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
terminal49 🟢 Ready View Preview Jul 27, 2026, 12:11 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants